Magnum One

home *** CD-ROM | disk | FTP | other *** search

/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d21 / commo421.arc / COMMO.DOC < prev next >

Wrap

Text File | 1990-07-19 | 75.2 KB | 2,162 lines

{COMMO} (tm) Telecommunications for PC Compatibles by Fred P. Brucker Post Office Box 9103 Santa Rosa, CA 95405 Release 4.21 April 14, 1990 This program and associated documentation are the property of the author and may not be sold without permission. They may be freely distributed, unaltered and as a unit, via electronic bulletin board systems. Permission to distribute on diskette or in any other manner must be obtained in writing. The author does not guarantee the program to be free from defects and may not be held responsible for loss caused by such. Your use of this program constitutes your acceptance of these terms. (C) Copyright 1989,1990 Fred P. Brucker All Rights Reserved Welcome to {COMMO} (tm) page ii --------------------- Licensing Information --------------------- {COMMO} is not a public domain program and is not free. It is classified as "SHAREWARE." What this means is that you may use the program for 30 days to determine its suitability to your application. If after that time you decide to continue using {COMMO} you must pay the registration fee. {COMMO} is a unique program and represents a great deal of work. A lot of functionality has been compressed into a small package, and more features are being added on a continuing basis. If you find {COMMO} useful and enjoyable, you can help support future improvements by registering your copy. A single-user license is $25.00. A diskette (5.25" or 3.5") will be provided for a $5.00 handling fee. Send a check or money order (US funds) to the address below. Details and multi-user (site) license information are provided in the file REGISTER.FRM. Thank you, and I hope you enjoy {COMMO}. Fred P. Brucker P.O. Box 9103 Santa Rosa, CA 95405 Welcome to {COMMO} (tm) page iii Contents -------- Principal Features . . . . . . . . . . . . . . . . . . . . . 1 The Best Way to Learn {COMMO} Quickly . . . . . . . . . . . 2 Operations Guide / Command Summary . . . . . . . . . . . . . 3 The Internal Editor . . . . . . . . . . . . . . . . . . . . 6 Uploading / Downloading . . . . . . . . . . . . . . . . . . 6 {COMMO} Auto Receive . . . . . . . . . . . . . . . . . 6 Getting Started . . . . . . . . . . . . . . . . . . . . . . 7 Command Line Options . . . . . . . . . . . . . . . . . 8 {COMMO} Support Files . . . . . . . . . . . . . . . . . 9 Initialization Procedure . . . . . . . . . . . . . . . 10 Terminal Screen . . . . . . . . . . . . . . . . . . . . 10 How to Use Online Help . . . . . . . . . . . . . . . . . . . 11 Modifying the Help File . . . . . . . . . . . . . . . . . . 11 Programming {COMMO} Macros . . . . . . . . . . . . . . . . . 12 Macro-id and Function Summary . . . . . . . . . . . . . 13 Additional Macro File Rules . . . . . . . . . . . . . . 13 Executing Macros . . . . . . . . . . . . . . . . . . . 13 Additional Macro Execution Rules . . . . . . . . . . . 14 {COMMO} Macro Functions . . . . . . . . . . . . . . . . . . 15 Table of {COMMO} Key-id's . . . . . . . . . . . . . . . . . 29 Appendix A Setting Up Your Modem . . . . . . . . . . . . . 30 Appendix B {COMMO} and Multi-Tasking . . . . . . . . . . . 32 DESQview . . . . . . . . . . . . . . . . . . . . . . . 32 OmniView . . . . . . . . . . . . . . . . . . . . . . . 33 Appendix C XON/XOFF Protocol . . . . . . . . . . . . . . . 34 Appendix D ASCII Character Representation . . . . . . . . 35 Appendix E Terminal Emulation . . . . . . . . . . . . . . 37 Printer Support . . . . . . . . . . . . . . . . . . . . 37 ANSI Keyboard Support . . . . . . . . . . . . . . . . . 37 VT102 Keyboard Simulation . . . . . . . . . . . . . . . 38 LIST is a product of Vernon D. Buerg DESQview is a trademark of Quarterdeck Office Systems OmniView is a trademark of Sunny Hill Software DSZ is a product of Omen Technology Inc. AutoDownload is a trademark of Omen Technology Inc. Puma is a product of Matthew Thomas Welcome to {COMMO} (tm) page 1 ------------------ Principal Features ------------------ {COMMO} is small in size and executes quickly. Powerful Macro Processor allows you to: 1) write macro "programs" to automate many common operations such as logins, reading messages, uploading/downloading. You can sit back and watch {COMMO} do the work -- or you can let {COMMO} perform these tasks in the middle of the night while you sleep. 2) assign any Function Key, Alt Key or Keypad Key to send a string to the modem, execute any DOS command, start any macro or initiate any {COMMO} function. 3) edit all macros without exiting {COMMO}, using the Internal Editor. Unlimited entries in the Dialing Directory. Multi Number Dialing supported from the command line. AutoBaud detect. Macro may be linked to each directory entry. Multi-tasking support. {COMMO} is DESQview aware, operates in about 40k and will execute with DSZ in a 110k DV window (depending on support file sizes). Also supports the TopView interface (with automatic screen updating, such as in OmniView). Built-in ANSI-BBS and VT102 emulation. Supports ANSI editing functions, scrolling region, graphics character set, tab set/clear, printing, modes, reports, etc. Complete auto-switching VT102 keyboard support via Macro Processor. ASCII Upload to send messages and text files. Features line pacing and blank line expansion. Configuration File, Dialing Directory and Macro File may be edited with full-function Internal Editor. String search available in all file windows. Most features are fully configurable. Split-screen Chat Mode -- all program features are available while in Chat Mode. {COMMO}'s Auto Receive feature recognizes Zmodem AutoDownload and Puma Auto-Start sequences, automatically triggering the macro of your choice. Support for any four serial ports. Port addresses and IRQ's are configurable. Port speeds up to 115,200 bps (machine dependent). Support for NS16550A buffered UART chip. Serial port signal lights may be displayed on status line, including send and receive. Welcome to {COMMO} (tm) page 2 Capture Log to save all text from the screen to a disk file. Screen Image Save to write current screen to a disk file. Print Log to write all text from the screen to the printer. Extensive context-related Online Help. And {COMMO} is elegant, easy to learn and fun to use! !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! ------------------------------------- The Best Way to Learn {COMMO} Quickly ------------------------------------- !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 1) Read the section "Operations Guide / Command Summary" for a quick introduction to all of {COMMO}'s commands and features. 2) Read Appendix A "Setting Up Your Modem" for some very important instructions pertaining to your specific hardware. 3) Read the section "Getting Started" which will get you up and running. 4) Use the extensive Online Help to learn the operating details of the program as you use it. How is it pronounced??? Just like "comma" (,) except for the last letter. It's technical jargon for "communications." Welcome to {COMMO} (tm) page 3 ---------------------------------- Operations Guide / Command Summary ---------------------------------- Use {COMMO}'s Online (context-related) Help facility to obtain operating details for most features. This section is an overview of {COMMO} features and commands, which you should peruse to gain rapid, overall familiarity with the program. (A special section in this document "Programming {COMMO} Macros" is devoted to the Macro Processor. Additionally there are several appendices which give details about special program features.) Note: the Alt Keys shown are the built-in default key assignments for the various {COMMO} functions. Once you are familiar with these functions you may reassign any of the keys using the Macro Processor. [Alt-A] ASCII Upload ------- ------------ Sends prepared messages and other text files to the remote system. This command features Line Pacing or XON/XOFF protocol to control the flow of data. [Alt-B] Send Break Signal ------- ----------------- Sends a Break Signal, used by some systems to interrupt an operation. [Alt-C] Clear Screen ------- ------------ Clears the Terminal Screen to the default colors. [Alt-D] Dialing Directory ------- ----------------- Maintains a data base of telephone numbers and related information. Dials numbers to establish connections with remote systems. Directory can be updated with the Internal Editor. [Alt-G] Configuration File ------- ------------------ Contains settings for many of {COMMO}'s operating parameters. Can be modified with the Internal Editor. Details in Online Help. [Alt-H] Online Help ------- ----------- Context-related Online Help is available at any time from anywhere within {COMMO}. See also the section "How to Use Online Help." Welcome to {COMMO} (tm) page 4 [Alt-I] Screen Image Save ------- ----------------- Appends the image of the current Terminal Screen to a disk file. Very useful for selectively recording information. Allows you to change the name of the Screen Image File at any time. See also "Capture File Options." [Alt-L] Set Terminal Parameters ------- ----------------------- Changes the current Serial Port, Data Rate, Data Format or Terminal Emulation Type. [Alt-M] Macro Processor ------- --------------- Executes and maintains {COMMO} macros. See the section "Programming {COMMO} Macros" which shows you how easily you can automate program operations, link to external protocols (for Uploading/Downloading), assign keys and perform a myriad of other functions. The Macro File is maintained with the Internal Editor. [Alt-O] Send Modem Initialization String ------- -------------------------------- Used to re-initialize your modem, if necessary. [Alt-P] Send Current Password ------- --------------------- Sends the Password String defined by the last dialing operation. This feature allows a different Password for each system that you call. [Alt-Q] Quit Call ------- --------- Places modem "on-hook" by dropping DTR. Used to "hang up" the telephone line. [Alt-S] Shell to DOS ------- ------------ Allows you to enter DOS while {COMMO} remains in memory. [Alt-U] Multi Number Dialing ------- -------------------- Multiple numbers may be "marked" in the Dialing Directory, then automatically dialed in sequence until a connection is established. See "Command Line Options" and "Programming {COMMO} Macros" for details on marking numbers. Welcome to {COMMO} (tm) page 5 [Alt-X] Exit from {COMMO} ------- ----------------- Terminates program, exits back to DOS. May be pressed from the Terminal Screen, Dialing Directory or Macro Processor. [Alt-1] Capture File Options ------- -------------------- When Capture is OPEN all information written to your screen will be saved to the designated disk file. This command allows you to OPEN/CLOSE the Capture File and to change to a different file. See also "Screen Image Save." [Alt-2] Print Log Toggle ------- ---------------- Turns the Print Log ON/OFF. When ON all information written to your screen will be printed to LPT1. Handy for getting hard-copy of file lists, messages, etc. [Alt-3] Sound Control Toggle ------- -------------------- Enables/disables all sounds, including alarms and beeps. Alarms and the number of alarm rings are individually configurable in the Configuration File and in the Macro File. [Alt-4] AutoBaud Toggle ------- --------------- Allows {COMMO} to adjust automatically to the data rate (speed of transmission) of the system you are calling. [Alt-5] Local Echo Toggle ------- ----------------- Used for calling a host system that does not echo what you type. The host must send a linefeed after each carriage return that you type. [Alt-0] Signal Light Toggle ------- ------------------- Turns ON/OFF the "modem lights" display on the status line. Shows the state of the RS-232 signals, including send/receive. [Alt--] Chat Mode Toggle (Alt minus) ------- ---------------- Turns Chat Mode ON/OFF. Split-screen shows received text in the top portion and typed text in the bottom portion. Used for conversing with someone at another terminal who is also in Chat Mode. Welcome to {COMMO} (tm) page 6 [Alt-=] Doorway Mode Toggle ------- ------------------- Turns Doorway Mode ON/OFF. Doorway Mode turns off the status line providing a 25-line display. Standard PC keyboard codes are transmitted so that you can operate remote applications. The Internal Editor ------------------- {COMMO}'s Internal Editor is easy to use, yet fully functional, allowing you to maintain your Configuration File, Dialing Directory and Macro File with lines up to 255 characters long. Full details in Online Help. ----------------------- Uploading / Downloading ----------------------- {COMMO} requires the use of external programs such as Omen Technology's DSZ.COM to do protocol transfers of files. The Macro File is pre-configured with macros that execute DSZ to perform Xmodem, Ymodem and Zmodem uploads and downloads. Use the Alt-M key command to select one of these macros. Installing DSZ is very easy. Just place DSZ.COM in a directory which is specified in your DOS path statement. If you don't have a path statement in your AUTOEXEC.BAT file, place DSZ.COM in your C:\COMMO directory. Then type "path c:\commo<cr>" before you call {COMMO}. {COMMO} Auto Receive -------------------- Two special macro-id's (see "Programming {COMMO} Macros") are used with {COMMO} Auto Receive: {.z.} Zmodem AutoDownload {.p.} Puma Auto-Start Just place the respective macro-id on your Zmodem or Puma receive macro and {COMMO} will execute the macro as soon as the sender is ready (be patient, a BBS may take several seconds to load and execute the protocol program). IMPORTANT: Be sure that DSZ.COM or PUMA.EXE are in your DOS path. If not, the message "Bad command or file name" will be periodically displayed by DOS. If this happens type Ctrl-X several times to abort the sender. Welcome to {COMMO} (tm) page 7 --------------- Getting Started --------------- First make sure that all of the files from the {COMMO} package are in one directory or on one diskette. Five of these files are required to run the {COMMO} program: COMMO.COM the Program File COMMO.CFG the Configuration File COMMO.FON the Dialing Directory File COMMO.MAC the Macro File COMMO.HLP the Online Help File There are two ways to make sure that {COMMO} will be able to find all of its files. The first method is the simplest and should be used if you are not too familiar with DOS commands: Make sure you are logged into the directory or disk drive where the files are located. Then simply type "commo" at the DOS prompt. If your files are in the directory "C:\COMMO" you would type: c:<cr> cd \commo<cr> commo<cr> (<cr> is the [Enter] or Return key) Or if the files are on a diskette in drive A you would type: a:<cr> commo<cr> {COMMO} will remember where the files are, so you will be able to change directory or drive later without concern. The second method is a little more advanced, but allows you to run {COMMO} no matter what directory or drive you are currently logged into: Use the SET command in DOS to store the {COMMO} path into the "environment." If you place this command in your AUTOEXEC.BAT file you won't have to change directories or diskettes to run {COMMO}. If your files are in the directory "C:\COMMO" the command would be: set commo=c:\commo If the files are on the diskette in drive B the command would be: set commo=b: Do not use any extra spaces in the SET command. And remember to place the {COMMO} directory or drive in your PATH command. IMPORTANT: Remember to execute the "set commo=" command again if Welcome to {COMMO} (tm) page 8 you install {COMMO} into a different directory or onto another drive. Otherwise the new copy will refer back to the old directory and use the old support files. This is a common error and can cause a lot of head scratching. -------------------- Command Line Options -------------------- Dialing Strings _______________ Dialing Strings may be placed before any command line switches. {COMMO} will search the Dialing Directory for each string and mark the first entry where a match is found (case is ignored). The strings may consist of any part of a Dialing Directory entry line and may be separated by commas or spaces. The following characters may not appear in a Dialing String: space, comma, slash (/), left or right curly brace. After entries in the Dialing Directory are marked, {COMMO} will check for a Startup Macro (see below). If no valid macro is present Multi Number Dialing of the marked systems will begin. If a macro is present it will be started instead. The Modem Initialization String will be sent before dialing begins unless the switch "/i=no" is present on the command line. Examples: commo telegodzilla joes-bbs 4567 commo zilla,joes,4567 IMPORTANT: Your modem should be turned on and ready to receive the Modem Initialization String before starting the program. Switches ________ /c=filename default: COMMO.CFG Alternate Configuration File. The alternate file must reside in the {COMMO} home directory. /i=[yes/no] default: none This switch may be used to inhibit the Modem Initialization when Dialing Strings and/or a Startup Macro are present: "/i=no." It may also be used to bypass the question "Initialize modem?" on the Initialization Screen: "/i=yes" or "/i=no." Welcome to {COMMO} (tm) page 9 /m=macro-id default: none Startup Macro. The "macro-id" is a three character macro identifier. If the macro is found in the Macro File it will be started. If the macro is not found the switch will be ignored. The Modem Initialization String will be sent before starting the macro unless the switch "/i=no" is present on the command line. /o=bf,bf default: 17,47 Colors for Initialization Window. The first field is the text area, the second field is the border. The "bf" is the same format as in the Configuration File (see Online Help for details). Does not apply to monochrome displays. Example: commo joes zilla /c=other.cfg /m=abc Two systems will be marked in the Dialing Directory. The alternate Configuration File "other.cfg" will be used (it must be located in the {COMMO} home directory). The macro "abc" will be started if it exists in the Macro File. Note that case is ignored and the order of the switches is unimportant (Dialing Strings must be first, however). --------------------- {COMMO} Support Files --------------------- The {COMMO} files are standard ASCII text files and may be modified with any editor (or word processor in "non-document" mode). In addition all but the Online Help File may be edited with {COMMO}'s Internal Editor. Following is a brief description of each file. 1) The Configuration File contains settings for many important parameters. When you first run {COMMO} you should use the Alt-G key command to edit this file to your own needs. Save the file by pressing [Esc], then "y" or [Enter]. Details for each item in this file are given in Online Help. 2) The Dialing Directory File. This file contains information about the systems you will be calling, including the telephone numbers, passwords, line parameters and macro link. Use the Alt-D key command to dial numbers and to edit this file. Details are given in Online Help. 3) The Macro File. Use the Alt-M key command to select a macro for Welcome to {COMMO} (tm) page 10 execution and to edit this file. A complete description of {COMMO} macros is given in the section "Programming {COMMO} Macros" in this document. A summary of macro functions and key designators is given in Online Help. 4) The Online Help File. Very extensive Online Help is available at the touch of a key from within {COMMO}. In fact most of the operating details of the program are ONLY obtained from Online Help. See "How to Use Online Help" later in this document. ------------------------ Initialization Procedure ------------------------ When {COMMO} begins running it will attempt to load the Configuration File (default is COMMO.CFG), COMMO.FON and COMMO.MAC. Any problems encountered will be reported in the Initialization Window. These problems must be corrected before restarting the program. Automatic modem initialization will occur if Dialing Strings are present (and matches are found), or if the Startup Macro Switch is present (see "Command Line Options"). Otherwise you will be asked if you want to initialize your modem. Answer "yes" unless you are already on line. Please note that {COMMO} does NOT change the video display mode. This means simply that the video mode must be set (usually 25 by 80 color or monochrome) when you call up the program. This allows you to set video parameters such as the screen border color and not have them rudely changed when the program is started. If the display does not look right try executing the DOS command "mode co80" or "mode bw80" prior to calling {COMMO}. --------------- Terminal Screen --------------- The Terminal Screen allows you to see the characters coming in from the serial port. Also any characters that you type will be sent to the serial port. If you are connected to another system you will be communicating with that system. From The Terminal Screen you may call upon any of {COMMO}'s features by holding the Alt key and pressing a letter or top row number key, then releasing both keys. To see a list of {COMMO} key commands use [Alt-H]. To return to The Terminal Screen simply press [Esc]. Welcome to {COMMO} (tm) page 11 ---------------------- How to Use Online Help ---------------------- Most of {COMMO}'s operating details are available as Online Help by pressing [Alt-H] from anywhere in the program. The Online Help support file, COMMO.HLP, must be in the {COMMO} home directory or you will get an error message, "Unable to open Help file." This message will also be issued if there is not enough memory (approx. 64k) to load the Online Help file. Note that the file is retained in memory until {COMMO} requires memory for some other program function. It will automatically be re-read when necessary. Once the Help window is entered you will see the Help control keys listed at the bottom of the screen. At this point you may obtain more detailed information on using Online Help by typing "H". ----------------------- Modifying the Help File ----------------------- Once you are familiar with {COMMO} you may wish to reduce the size of the Help File. Feel free to edit this file with an external editor -- you can even set up your own menu. The search keys are the bars separating the topics. The two digit number in the middle of the bar may be changed to create your own key. Remember to keep a backup of the original Help File. Welcome to {COMMO} (tm) page 12 -------------------------- Programming {COMMO} Macros -------------------------- See the sample Macro File, COMMO.MAC, for examples of more complex macro programming. {COMMO} macros may be used to perform many different operations, yet their structure is simple and consistent. Here are some examples: {alk} {clear} {stop} This macro will set Alt-K to clear the screen. "alk" is called a "macro identifier" or "macro-id" for short. It may be any three characters. Certain macro-id's are reserved to represent keys on the keyboard, such as "alk" in this case, and are called "key-id's." CLEAr is called a "function" and is represented by four or more characters of which only the first four are necessary. The STOP function is used here to terminate the macro and may be used in either it's long or short form: ... {stop} long form ... {} short form Note that the default key to clear the screen, Alt-C, is still in effect unless it is reassigned. All of {COMMO} key-id's and functions are described in later sections. They are also summarized in Online Help. {abc} {setlook 30,hng,3,|} {lookfor first name?} {sendFred|} {} In this macro the SETLook function will set timeout parameters for subsequent LOOKfor functions. The LOOKfor will then watch the data coming in from the modem and when it sees "first name?" it will pass control to the next function. In this case the next function, SEND, will send the string "Fred" followed by a carriage return (indicated by the "|"). Again the STOP function terminates the macro. {bbs} {capture y,commo.cap} {call abc} {asciiup textfile.xyz,:} {} This macro will open the capture file "commo.cap" (the "y" means "yes", open the file). Then it will execute the previously described macro "abc." Then it will ASCII Upload the file "textfile.xyz" using the pacing character ":". Note that macros may occupy more than one line in the Macro File. Welcome to {COMMO} (tm) page 13 Macro-id and Function Summary ----------------------------- Macro-id's must be three characters (any character that may be entered in the Internal Editor is valid). Case is ignored so that "GK1" is the same as "gk1" or "gK1." Macro-id's may appear anywhere within macros and may be the targets of CALL and GOTO functions. Multiple macro-id's may refer to the same macro: {aln} {aly} {dial 50,abc} {}. Two macro-id's are reserved for {COMMO}'s Auto Receive feature: {.z.} Zmodem AutoDownload {.p.} Puma Auto-Start Simply place the respective macro-id on the Zmodem or Puma receive macro and the macro will be started automatically. Auto Receive operations are not available when a macro is running -- use a RETUrn at the end of the macro and execute it with a CALL. Function names are four or more characters and may always be abbreviated to the first four. Case is ignored here as well. Remember to terminate each macro with a STOP function unless it already ends with a GOTO or RETUrn. If you don't, processing will continue with the next macro in your Macro File! Additional Macro File Rules --------------------------- The Macro File is entirely free-form. Macro-id's and functions may appear on the same line or on separate lines. More that one macro-id may appear on the same line (only the first may be executed from the Macro File window using the Selector Bar): {ala} {clear} {} {alw} {sound n} {} Comments may appear anywhere outside the curly braces. Executing Macros ---------------- Macro execution may be started in a number of ways: 1) Open the Macro Processor window (Alt-M), position the Selector Bar on the macro-id and press [Enter] (the macro-id must be the first string on the line). 2) If the macro-id is also a key-id, then you may press that key from the Terminal Screen. If the same key-id is used more than Welcome to {COMMO} (tm) page 14 once, the first occurrence will be used. 3) The macro may be linked to a Dialing Directory entry. In this case it will be CALLed when a connection is established with that system. 4) The macro may be specified on the command line with the switch "/m=". It will be started as soon as {COMMO} has initialized itself. 5) The macro may be an argument of another function such as CALL, GOTO, DIAL or SETLook (these are detailed in a later section). Additional Macro Execution Rules -------------------------------- ASCII keys may be typed to the serial port during LOOKfor, PAUSe and HOLD functions. To send an Esc code press Ctrl [ (Ctrl + left bracket). The Macro Processor will execute functions in order until one of the following conditions occur: 1) A CALL, GOTO, RETURn, STOP or EXIT is encountered. 2) Control is transferred to an alternate macro from certain functions when a special condition occurs. An example of this is the SETLook function. The alternate will execute when a subsequent LOOKfor times out. 3) The end of the Macro File is reached. Current function execution may be terminated by pressing [Esc]. For example, to terminate a PAUSe or HOLD prematurely. Overall macro execution may be terminated by pressing [Ctrl-Break]. This will issue an [Esc] to the currently executing function, then terminate macro processing and return you to the Terminal Screen. Macro errors will also terminate macro execution and bring up the Macro Error window, indicating the location of the problem. Some macro functions show their current action on the status line at the bottom of the screen. In addition, a "face" character in the middle of the status line indicates that a macro is executing. Welcome to {COMMO} (tm) page 15 ----------------------- {COMMO} Macro Functions ----------------------- The purpose of this section is to show the syntax of each function and the meaning of its arguments through examples. Details on functions which are also default key commands may be found in Online Help. Other functions will be explained in this section. Function names are shown with their four-letter abbreviations in uppercase. The following conventions are used in many functions: "y" or "yes" is used to indicate "yes", "on", "open", etc. "n" or "no" is used to indicate "no", "off", "close", etc. This provides a highly consistent macro structure which is very easy to remember. When a function is also associated with a default key command, the lack of arguments will cause the function to behave like the key command -- bringing up a window, for example. Function Arguments ------------------ Arguments are the parameters that follow the function name. One space separates the function name from the arguments (extra spaces should be avoided). Multiple arguments are separated by commas. {bbs} {capture y,commo.cap} {call abc} {asciiup textfile.xyz,:} {return} Here the function CAPTure has two arguments: "y" and "commo.cap." {abc} {lookfor first name?} {send Fred|} {} The function LOOKfor has one argument: "first name?". Quotation marks are NOT used to enclose data strings or filenames in {COMMO} macros. Welcome to {COMMO} (tm) page 16 ALARm ----- Default key: none Description: Ring the alarm Examples: {alarm} Ring alarm, ring count in Config. File {alarm 2} Ring alarm 2 times ASCIiup ------- Default key: Alt-A Description: Upload an ASCII (text) file Examples: {asci} Open ASCII Upload window {asci file.xyz,:} Upload "file.xyz." Use ":" for pacing {asci file.xyz} Same, but use current pacing character {asci file.xyz,} Same, but no pacing {asci ,?} Set current pacing character to "?" {asci ,} Set current pacing to "no" pacing The pacing character may be entered according to the rules in Appendix D "ASCII Character Representation." For example, "^m" or "|" may be used to represent the carriage return. AUTObaud -------- Default key: Alt-5 Description: Set AutoBaud toggle Examples: {auto} Toggle AutoBaud on/off {auto y} Turn on AutoBaud {auto n} Turn off AutoBaud BEEP ---- Default key: none Description: Sound a beep Examples: {beep} No arguments Welcome to {COMMO} (tm) page 17 BREAk ----- Default key: Alt-B Description: Send a break Example: {break} No arguments CALL ---- Default key: none Description: Execute another macro Example: {call abc} Execute macro abc If the macro "abc" executes a RETUrn function, then control returns to the function following the CALL. Note that macros may be nested up to 32 deep. CAPTure ------- Default key: Alt-1 Description: Capture File Options Examples: {capture} Open Capture File Options window {capture y} Open current Capture File {capture n} Close current Capture File {capt y,c:\commo\file.xyz} Open indicated Capture File {capt n,c:\dl\newfile.cap} Close current Capture File, set new file as indicated CHATmode -------- Default key: Alt-- (Alt minus) Description: Set Chat Mode toggle Examples: {chat} Toggle Chat Mode on/off {chat y} Turn on Chat Mode {chat n} Turn off Chat Mode Welcome to {COMMO} (tm) page 18 CLEAr ----- Default key: Alt-C Description: Clear Terminal Screen to default colors Example: {clear} No arguments CONFig ------ Default key: Alt-G Description: Edit Configuration File Example: {config} No arguments DIAL ---- Default key: Alt-D, Alt-U Description: Dialing Directory Examples: {dial} Open Dialing Directory window (like Alt-D) {dial ,} Multi Number Dial (like Alt-U) {dial 25,abc} Multi Number dial with try count 25 Maximum number of dialing tries. If no connection is established when the try count is exhausted, the macro in the second argument will be started. May be 0 to 999. "0" means unlimited. abc Macro to GOTO if the try count in the first argument is exhausted. If no macro is specified or if the macro-id is invalid, control will pass to the next function. Default arguments are: Dialing tries 0 (unlimited) Macro none Null arguments in the DIAL function will revert to these defaults. Marked numbers will be redialed in sequence. Numbers may be marked in several ways: 1) Manually in the Dialing Directory window. 2) By placing Dialing Strings on the command line. 3) Using the MARK macro function. Welcome to {COMMO} (tm) page 19 If a connection occurs there are two possibilities: 1) If a valid macro is specified in the Dialing Directory, that macro will be started. When a RETUrn function is encountered {COMMO} will continue dialing other numbers if any are marked. When no more marked numbers are found, control returns following the DIAL function. This allows more than one system to be called automatically. Use a {stop} or {} at the end of the macro to begin manual operation. At the end of the call press Alt-U to continue Multi Number Dialing. 2) If no macro is specified in the Dialing Directory, control is returned to the Terminal Screen and macro processing is terminated. See also the functions: MARK, UNMArk. EXECute ------- Default key: none Description: Execute a DOS command A number of special parameters are available to the EXECute function which will either substitute the current value of a variable or perform a specific action before/after command execution: %i general user Input prompt %p current serial Port no. (1,2,3 or 4) %s current Speed (1200, 2400, etc.) %u current Upload directory (from Config) %d current Download directory (from Config) %c current Capture file (use Alt-1 to check) %a sound Alarm at end of command execution %w Wait (pause) before returning to Terminal Screen %% insert an actual "%" into the command "%i" may be used more than once in a command and will result in a prompt for input in the EXECute DOS Command window. This is an opportunity to enter a filename or any other information pertinent to the execution of the command. "%w" causes a wait before restoring the Terminal Screen. This is useful if you need to see the results of the command execution. A wait before and after each EXECute function may be forced by starting a macro with [Ctrl-Enter] instead of [Enter] (from the Macro Processor window only). Examples: {exec dsz port %p speed %s sz %u\%i %a%w} Welcome to {COMMO} (tm) page 20 {COMMO} will prepare the DSZ command by substituting the "%" parameters, then call DOS to execute the program. The alarm will sound at completion and {COMMO} will wait for a keypress before resuming. {exec list %c} The LIST program will be executed with the current Capture File as a command line argument. {COMMO} will return immediately to the Terminal Screen when LIST exits. EXEN ---- Default key: none Description: Execute a DOS command, do not clear the screen This function is exactly the same as EXECute, but the Terminal Screen is not cleared when the command is sent to DOS. It is used to prevent the screen from "flickering" when programs or DOS commands execute rapidly. Examples: {exen del c:\commo\commo.cap} {exen ren commo.cap joes-bbs.cap} EXIT ---- Default key: Alt-X Description: Exit {COMMO} Example: {exit} No arguments GOTO ---- Default key: none Description: Transfer control to a macro-id Example: {goto x21} Control transferred to "x21" Welcome to {COMMO} (tm) page 21 HANGup ------ Default key: Alt-Q Description: Disconnect by dropping DTR Examples: {hangup} Prompt user for disconnect {hangup y} Disconnect without prompting HELP ---- Default key: Alt-H Description: Open Online Help window Example: {help} No arguments HOLD ---- Default key: none Description: Hold until specified time of day (24 hour format) Examples: {hold 3:30} Hold until 3:30 am {hold 16:10} Hold until 4:10 pm {hold 0:00} Hold until midnight INITmodem --------- Default key: Alt-O Description: Send Modem Initialization String Example: {init} No arguments LIGHts ------ Default key: Alt-0 Description: Set Signal Lights toggle Examples: {lights} Toggle Signal Lights on/off {lights y} Turn on Signal Lights {lights n} Turn off Signal Lights Welcome to {COMMO} (tm) page 22 LOCAlecho --------- Default key: Alt-6 Description: Set Local Echo toggle Examples: {local} Toggle Local Echo on/off {local y} Turn on Local Echo {local n} Turn off Local Echo LOOKfor ------- Default key: none Description: Look for a string in the modem input stream Examples: {setlook 60,abc,4,n|} Set parameters {lookfor first name?} Look for the string "first name?" {look ^(COMMO^)} Look for the string "{COMMO}" Parameters controlling LOOKfor execution are set with the SETLook function, which should be executed before any LOOKfor functions. See description of SETLook function for details. The LOOKfor function will watch for the requested string to appear, then macro execution will continue with the next function. Case will be ignored and ANSI control sequences will be stripped (if ANSI emulation is enabled). Thus you needn't be concerned about remembering if any characters were upper or lower case, nor do you have to tell the remote to turn off ANSI graphics. Note that there are special rules for representing characters in LOOKfor strings. See Appendix D "ASCII Character Representation" for details. MACRo ----- Default key: Alt-M Description: Open Macro Processor window Example: {macro} no arguments Welcome to {COMMO} (tm) page 23 MARK ---- Default key: none Description: Mark Dialing Directory entries for dialing Example: {mark joes-bbs,file-city} Mark entries for dialing Dialing Strings may be separated by spaces or commas. {COMMO} will search the Dialing Directory for each string and mark the first entry where a match is found. Case is ignored. The strings may consist of any part of a Dialing Directory entry line. However the following characters may not appear in a dialing string: space, comma, slash (/), left or right curly brace. See also the functions: DIAL, UNMArk. NOOP ---- Default key: none Description: No-op function, does nothing Example: {noop} no arguments PARMs ----- Default key: Alt-L Description: Set Terminal Parameters Examples: {parms 2,2400,8,V} Set Com2, 2400 bps, 8,n,1, VT102 {parms ,9600} Set 9600 bps {parms 1,19200,7} Set Com1, 19200 bps, 7,e,1 {parms ,,,a} Set ANSI-BBS Welcome to {COMMO} (tm) page 24 PASSword -------- Default key: Alt-P Description: Send current password Example: {password} No arguments The current password is obtained from the Dialing Directory entry whenever a number is dialed. If no password is specified no characters will be sent. PAUSe ----- Default key: none Description: Pause for up to 999 seconds Example: {pause 25} Pause for 25 seconds PRINtlog -------- Default key: Alt-2 Description: Set Print Log toggle Examples: {print} Toggle Print Log on/off {print y} Turn on Print Log {print n} Turn off Print Log RETUrn ------ Default key: none Description: Return from a CALLed macro Example: {return} no arguments This function is used in the following situations: 1) To end a macro started by a CALL. Control returns following the CALL function. 2) To end a Dialing Directory macro. If dialing was initiated from a DIAL macro function, dialing will continue if any more numbers are marked. If no more numbers are marked, then control will pass to the function following DIAL. Welcome to {COMMO} (tm) page 25 Note: If a RETUrn is encountered and no CALL has been executed, a STOP will occur. This is useful in macros that are CALLed and are also used standalone (such as protocol file transfer macros). SCREen ------ Default key: Alt-I Description: Screen Image Save Examples: {screen} Open Screen Image Save window {screen y} Append screen image to current file {screen y,commo.scn} Append screen image to indicated file (and change current pathname) {screen n,c:\file.xyz} Change current screen image pathname (don't save screen to file) SEND ---- Default key: none Description: Send a string to the modem Example: {send Fred|~~Brucker|~~#|} Send my first and last name with carriage returns and 1 second delays, then send the current password and <cr>. Note: see Appendix D "ASCII Character Representation" for information on how to represent any character in a SEND function. SETLook ------- Default key: none Description: Set parameters for LOOKfor functions Example: {setl 60,abc,4,n|} Set LOOKfor parameters 60 LOOKfor timeout. Maximum time in seconds to look for a string. If the string is not found in the allotted time, the macro in the second argument will be started. May be 0 to 999. "0" means forever. abc Timeout macro. Macro to GOTO if the time in the first argument expires. If no macro is specified or if the macro-id is invalid, control will pass to the next function. 4 Prompt timeout. During a LOOKfor function unwanted prompts may appear like "Press any key" or "More [Y/n]", etc. Welcome to {COMMO} (tm) page 26 This argument is the time in seconds to wait at a prompt (no input from the modem) before sending the string in the fourth argument. Usually you would send "|" or "n|". When the string is sent the process is restarted, allowing any number of prompts to be satisfied (until the LOOKfor itself is satisfied or times out). Make sure this value is high enough to give the host system time to "think" when it is in between prompts. Some systems take longer to do things. May be 0 to 999. "0" means forever. n| Prompt response. String to send when the time in the third argument runs out. The SETLook function will set parameters for any subsequent LOOKfor's. SETLook may be executed at any time to modify the parameters. Default arguments are: LOOKfor timeout 0 seconds Timeout macro none Prompt timeout 0 seconds Prompt response none Null arguments in the SETLook function will revert to these defaults. SHELl ----- Default key: Alt-S Description: Shell to DOS Example: {shell} No arguments SOUNd ----- Default key: Alt-3 Description: Set Master Sound toggle Examples: {sound} Toggle Master Sound on/off {sound y} Turn on Master Sound {sound n} Turn off Master Sound Welcome to {COMMO} (tm) page 27 STOP ---- Default key: none Description: Halt macro execution Examples: {stop} No arguments {} Short form STOP always returns {COMMO} to manual operation in the Terminal Screen. It should be used to end login macros. UNMArk ------ Default key: none Description: Unmark all entries marked for dialing in the Dialing Directory Example: {unmark} No arguments See also the functions: DIAL, MARK. VTCUr ----- Default key: none Description: Define a VT102 cursor (arrow) key Example: {vtcur ^[[A|^[OA} Define up-arrow key strings The first string is sent when cursor mode is active; the second string is sent when application mode is active (these modes are controlled by the host). The two strings must be separated by a "|". Use "^m" for carriage return if necessary. Welcome to {COMMO} (tm) page 28 VTPAd ----- Default key: none Description: Define a VT102 keypad key Example: {vtpad 5|^[Ou} Define keypad "5" key strings The first string is sent when numeric mode is active; the second string is sent when application mode is active (these modes are controlled by the host). The two strings must be separated by a "|". Use "^m" for carriage return if necessary. Welcome to {COMMO} (tm) page 29 ------------------------- Table of {COMMO} Key-id's ------------------------- Key-id's are also macro-id's with the added advantage that the macro can be started by pressing the associated key from the Terminal Screen. Most "special" keys may be assigned this way. If the same key-id appears more than once, the first occurrence will be used. Note that key-id's are case insensitive. The caret (^) indicates the Ctrl key. Key Name Key-id Key Name Key-id ________ ______ ________ ______ Normal-F1 nf1 ... Normal-F10 nf0 Ctrl-F1 cf1 ... Ctrl-F10 cf0 Shift-F1 sf1 ... Shift-F10 sf0 Alt-F1 af1 ... Alt-F10 af0 Alt-A ala ... Alt-Z alz Alt-1 al1 ... Alt-0 al0 Alt = al= Alt - al- Escape esc Grey * gr* Grey - gr- Grey + gr+ Backspace bsp ^Backspace cbs Tab tab Shift-tab stb Enter ent ^Enter cen Home hom End end PgUp pgu PgDn pgd Up-Arrow upa Down-Arrow dna Left-Arrow lfa Right-Arrow rta Insert ins Delete del ^Home chm ^End cnd ^PgUp cpu ^PgDn cpd ^Right-Arrow cra ^Left-Arrow cla Keypad-0 kp0 ... Keypad-9 kp9 Keypad-. kp. ^PrtSc cpr Welcome to {COMMO} (tm) page 30 ---------- --------------------- Appendix A Setting Up Your Modem ---------- --------------------- Please be aware that there are many different modems in use and that it is of the utmost importance that you configure your modem to work correctly with {COMMO}. A few tips will be given here, but they are no substitute for the detailed installation instructions in your modem manual! When {COMMO} is started a command string will be sent to the modem called the Modem Initialization String. You must make certain that the correct string is set up in your Configuration File (Item 4). This string will perform part or all of the modem setup depending on the type of modem. Examples will be given for the most common types. If your modem is external to your computer, be sure you have followed the installation instructions carefully and that the cable is connected to the computer's serial port. It is wise to turn off power to the computer and the modem when connecting or disconnecting any cables. Note the number of the serial port that you have used -- Com1, Com2, ... , etc. The numeric part of the serial port number (1, 2, ... ) must be placed in Item 1 of the Configuration File. Also check the default speed in Item 2. 1200 bps Modems _______________ Most 1200 bps modems have switches on them which must be set to provide the proper interaction with your computer and with {COMMO}. Consult your modem manual concerning these switches and pay particular attention to the following: 1) Enable command recognition. Allows the modem to recognize commands (dial, set registers, etc.). Must be in the "enable" position or modem will be unusable. 2) Send result codes in English. This switch should be set so that the modem will send verbal responses to commands instead of numbers. This is usually controlled by a command also (such as ATV1). 3) Respond to DTR (data terminal ready). This should NOT be in the "ignore" position. This switch allows the computer to signal the modem to hang up. 4) Force carrier detect. This switch should be set to "respond to carrier detect" or "allow true carrier." Here is an example modem initialization string (Configuration File Item 4) which will set up a 1200 bps modem and override the switch settings (if possible): Welcome to {COMMO} (tm) page 31 4 * {AT S0=0 S7=60 E0 Q0 V1 X1 |} Modem init string The most important command is the "X" command, since its function varies the most from modem to modem. The "X" command determines which responses the modem will generate during dialing (e.g. CONNECT, BUSY, etc.). It may also activate an additional modem feature such as automatic redialing which will interfere with {COMMO}'s own redialing procedure. Your modem manual gives a description for each level of the "X" command: X0, X1, X2, ... , etc. Generally you want to use the highest level that does not activate undesirable features. If you will be using {COMMO}'s AutoBaud feature you will need the extended connect responses such as CONNECT 1200. Also the BUSY response should be provided if possible. In any case you should modify the Modem Initialization String to work with your particular modem. 2400 bps and higher ___________________ Modems which operate at 2400 bps and higher generally have commands to replace the switches. These commands may be given every time you start {COMMO} or they may be permanently remembered by modems which have "non-volatile" memory. It will be assumed here that the commands are given every time you start {COMMO}. If you wish to place the settings in non-volatile memory, consult your modem manual on how to do this. Here is an example initialization string for 2400 bps (and higher) modems: 4 * {AT S0=0 S7=60 E0 Q0 V1 X4 &C1 &D2 |} Modem init string See the comments above concerning the "X" command since they apply to these modems as well. If {COMMO} is already running you may edit the Configuration File with the Alt-G key command, change the modem initialization string (save the file), then use the Alt-O key command to send the string to the modem. Normally the string is sent to the modem when {COMMO} is started. Welcome to {COMMO} (tm) page 32 ---------- ------------------------- Appendix B {COMMO} and Multi-Tasking ---------- ------------------------- DESQview -------- Special care has been taken to insure that {COMMO} is compatible with Quarterdeck Office Systems' DESQview(tm), a multi-tasking supervisor. DESQview allows more than one program to execute at the same time. A sample Program Information File (CO-PIF.DVP) has been included in the {COMMO} package for your convenience. This file has been set up to define a 120k memory window, allowing DSZ and LIST to be run from the Macro Processor. If a DOS command (or program run from the Shell to DOS) will not execute due to insufficient memory, this number will have to be increased. Be sure to test DOS commands with a "wait" at the end so that you can see any error messages (see EXEC function). You may be able to make this window smaller by reducing the size of {COMMO}'s support files and/or by running smaller programs with Shell to DOS or with the Macro Processor. CO-PIF.DVP can be changed with the CP (Change Program) command on the Open Window menu. You may also want to change the directory information or other parameters. Here are some tips on using {COMMO} with DESQview: If you switch to another task, do not attempt to access any files which may be in use in the {COMMO} window. Examples are the Capture File, the Screen Image File and files that may be currently involved in a file transfer (upload or download). The result may be a loss of part or all of the data in the file. This is a general DESQview no-no. You may freely access these files in the Shell to DOS or Macro Processor features of {COMMO} (within the same window). If the window is too small, {COMMO} will not be able to load the Online Help file. To use Online Help you will need a window with about 64k of memory available AFTER loading {COMMO}. Since the Online Help file is loaded only when requested, you needn't be concerned if you don't intend to use it. The video display may seem less smooth in DESQview. This is a result of {COMMO} using the fastest possible display method, and is quite normal. The Snow Checking toggle should not be used when {COMMO} is run under DESQview. If you see "snow" type interference in your CGA display, use DESQview's own snow checking (request "synchronized access" in the Setup program). Welcome to {COMMO} (tm) page 33 OmniView -------- Display bleed-through may be avoided by telling OmniView that {COMMO} "Supports TopView Functions" or by using the "/T" switch on the OmniView command line. See the tips on using {COMMO} with DESQview in the previous section, which apply to OmniView as well. Welcome to {COMMO} (tm) page 34 ---------- ----------------- Appendix C XON/XOFF Protocol ---------- ----------------- The XON/XOFF protocol is in effect at all times. XON/XOFF is especially important when the Print Log is on, since the printer is a slow device relative to the transmission rate of data. {COMMO} will send an XOFF (^S) to pause the remote when data is coming in too fast, and then send an XON (^Q) when it has caught up. If you attempt to type a character to the remote during a pause a beep will sound (the character will be ignored). Try typing the character again; if that fails turn off the Print Log. This situation may arise, for example, if you want to type a ^K to stop the output of the BBS (you probably want to stop the Print Log at this point anyway). Welcome to {COMMO} (tm) page 35 ---------- ------------------------------ Appendix D ASCII Character Representation ---------- ------------------------------ Sometimes it is necessary to enter special characters in the {COMMO} support files (Configuration File, Dialing Directory and Macro File) or as input to {COMMO} key commands. As an example, suppose you wanted to put a carriage return into a SEND macro function. If you pressed the Enter key while typing into the Macro File, {COMMO} would think you simply wanted the cursor to go to the beginning of the next line. In other words, certain control characters are used in the operation of {COMMO} and need to be entered in a special way if they are to be used as data. This section defines how to represent these characters as data. In general, Curly braces { } may ONLY appear as shown in the descriptions and examples for each of the support files. ASCII Data Strings __________________ Strings of ASCII characters appear in many places in the {COMMO} support files, including: Modem initialization string (Config. File) Dial prefixes (Config. File) Dial suffix (Config. File) Telephone number (Dialing Directory) Password string (Dialing Directory) Strings in macro functions such as SEND, SETLook and LOOKfor (Macro File) Note that most of these are sent to the modem. The following characters have special significance in ASCII Data strings: The vertical bar (|) represents a carriage return. The tilde (~) forces a one-half second delay (modem output only). The pound sign (#) will cause the current Password String to be sent in its place (in the SEND function only). Welcome to {COMMO} (tm) page 36 Every character in the extended ASCII chart may be represented: The caret (^) is used to represent ASCII values which may not be entered from the keyboard: 0 ... ^@ 7 ... ^G 14 ... ^N 21 ... ^U 1 ... ^A 8 ... ^H 15 ... ^O 22 ... ^V 2 ... ^B 9 ... ^I 16 ... ^P 23 ... ^W 3 ... ^C 10 ... ^J 17 ... ^Q 24 ... ^X 4 ... ^D 11 ... ^K 18 ... ^R 25 ... ^Y 5 ... ^E 12 ... ^L 19 ... ^S 26 ... ^Z 6 ... ^F 13 ... ^M 20 ... ^T 27 ... ^[ The caret (^) is also used to represent the following: { ... ^( the left curly brace } ... ^) the right curly brace | ... ^| the vertical bar ~ ... ^~ the tilde # ... ^# the pound sign ^ ... ^^ the caret These particular characters should only appear in this form, while others such as ASCII 28 through 31 and those in the upper 128 extended character set may be typed using the Alt-numeric-keypad method as follows: 1. Hold down the Alt key (and keep it down). 2. Enter the ASCII code in decimal using the numeric keypad keys (1, 2 or 3 digits are ok). 3. Release the Alt key. ASCII 28 through 31 may also be typed using the Ctrl key on your keyboard: 28 ... Ctrl \ 29 ... Ctrl ] 30 ... Ctrl 6 31 ... Ctrl - All other characters are entered in the usual manner. Welcome to {COMMO} (tm) page 37 ---------- ------------------ Appendix E Terminal Emulation ---------- ------------------ Terminal Emulation Type is indicated on the status line (to the right of the Line Parameters). Available types are: A ANSI-BBS Used on bulletin boards and other systems V VT102 Used on minicomputers and mainframes T TTY Supports only the basic control characters Initial Terminal Emulation Type is set in the Configuration File. Terminal Type may be changed at any time using the Alt-L key command. When a change is made, a reset of mode parameters will be performed. It is therefore important that the change be made BEFORE connecting with a host (modes are controlled by the host). Printer Support --------------- {COMMO} supports the ANSI/VT102 printer functions, controlled by the remote system. The "Printer ON/OFF" function will turn {COMMO}'s Print Log ON/OFF. The "Dedicated Printing" function will send all input from the serial port directly to the printer. This allows for "transparent" transmission of printer data, including control codes. The printer should be on and ready to print when either mode is used. When "Dedicated Printing" is active no characters will be displayed on the screen. ANSI Keyboard Support --------------------- The sample Macro File has support for the following special keys that are used with some BBS full-screen editors and in conjunction with VT102 keyboard simulation (^ indicates the Ctrl key): Four cursor (arrow) keys Home - Home cursor ^Home - Insert line PgUp - Page up ^PgUp - Delete line PgDn - Page down ^PgDn - Clear screen End - End of line Ins - Insert mode Del - Delete ^bs - Ctrl backspace (delete) The four cursor keys are auto-switched by the host system between cursor mode and application mode. Welcome to {COMMO} (tm) page 38 VT102 Keyboard Simulation ------------------------- Two keyboard files provide additional support to simulate the VT102 keyboard. One of these should be merged into your Macro File if you intend to use VT102 Emulation. Be sure that you have no conflicting key-id's in your Macro File (remember that {COMMO} will use the first occurrence of a key-id). These files may be modified to create any keyboard support you desire (see description of VTCUr and VTPAd functions in the section "{COMMO} Macro Functions." VT102 keypad keys are auto-switched by the host system between numeric mode and application mode. VT102-1.MAC ___________ This file contains keyboard assignments that work best with the enhanced keyboard (because of the separate cursor keys, etc.). With Numlock ON the ten digits and period will simulate their equivalent VT102 functions. In addition: F1 to F4 simulate PF1 to PF4 Grey * is used for comma Grey - is used for dash Grey + is used for Enter VT102-2.MAC ___________ This file contains keyboard assignments that work best with the 83- key keyboard (because of the location of the function keys on the left side). The following diagram shows how the ten function keys (Fn) and ten shifted function keys (SFn) relate to the VT102 keypad keys: F1= PF1 F2= PF2 SF1= PF3 SF2= PF4 F3= 7 F4= 8 SF3= 9 SF4= - F5= 4 F6= 5 SF5= 6 SF6= , F7= 1 F8= 2 SF7= 3 SF8= Enter F9= 0 F10= 0 SF9= . SF10= Enter - end -